<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>更新所有关联主机的状态信息</title>

 </head>
 <body><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="mongoclient.getconnections.html">MongoClient::getConnections</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="mongoclient.getreadpreference.html">MongoClient::getReadPreference</a></div>
 <div class="up"><a href="class.mongoclient.html">MongoClient</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="mongoclient.gethosts" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">MongoClient::getHosts</h1>
  <p class="verinfo">(PECL mongoclient &gt;=1.1.0)</p><p class="refpurpose"><span class="refname">MongoClient::getHosts</span> &mdash; <span class="dc-title">更新所有关联主机的状态信息</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-mongoclient.gethosts-description">
  <h3 class="title">说明</h3>
  <div class="methodsynopsis dc-description">
   <span class="modifier">public</span> <span class="type">array</span> <span class="methodname"><strong>MongoClient::getHosts</strong></span>
    ( <span class="methodparam">void</span>
   )</div>


  <p class="para rdfs-comment">
   此方法仅在连接到副本集时有用。
   它返回了集群里所有主机的状态。如果没有副本集，它只返回一个元素的数组，包含你当前连接的主机。
  </p>

  <p class="para">
   参见手册中<a href="mongo.queries.html" class="link">查询一节</a>关于分布式查询备份节点的信息。
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-mongoclient.gethosts-parameters">
  <h3 class="title">参数</h3>
  <p class="para">此函数没有参数。</p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-mongoclient.gethosts-returnvalues">
  <h3 class="title">返回值</h3>
  <p class="para">
   返回集群中主机的信息数组。
   包含了每个主机的主机名，它的健康程度（1 是很健康），它的状态（1 是活跃节点，2 是备用节点，0 是其他），ping 服务器所需的时间，以及最后一次 ping 的时间。
   例如，在具有三个成员的集群中，它看上去可能是这样的：
  </p>
  <div class="example-contents screen">
<div class="returnvaluescode"><pre class="returnvaluescode">array(3) {
  [&quot;A:27017&quot;]=&gt;
  array(4) {
    [&quot;host&quot;]=&gt;
    &quot;A&quot;
    [&quot;port&quot;]=&gt;
    27017
    [&quot;health&quot;]=&gt;
    int(1)
    [&quot;state&quot;]=&gt;
    int(2)
    [&quot;ping&quot;]=&gt;
    int(369)
    [&quot;lastPing&quot;]=&gt;
    int(1309470644)
  }
  [&quot;B:27017&quot;]=&gt;
  array(4) {
    [&quot;host&quot;]=&gt;
    &quot;B&quot;
    [&quot;port&quot;]=&gt;
    27017
    [&quot;health&quot;]=&gt;
    int(1)
    [&quot;state&quot;]=&gt;
    int(1)
    [&quot;ping&quot;]=&gt;
    int(139)
    [&quot;lastPing&quot;]=&gt;
    int(1309470644)
  }
  [&quot;C:27017&quot;]=&gt;
  array(4) {
    [&quot;host&quot;]=&gt;
    &quot;C&quot;
    [&quot;port&quot;]=&gt;
    27017
    [&quot;health&quot;]=&gt;
    int(1)
    [&quot;state&quot;]=&gt;
    int(2)
    [&quot;ping&quot;]=&gt;
    int(1012)
    [&quot;lastPing&quot;]=&gt;
    int(1309470644)
  }
}</pre>
</div>
  </div>
 </div>


 <div class="refsect1 changelog" id="refsect1-mongoclient.gethosts-changelog">
  <h3 class="title">更新日志</h3>
  <p class="para">
   <table class="doctable informaltable">
    
     <thead>
      <tr>
       <th>版本</th>
       <th>说明</th>
      </tr>

     </thead>

     <tbody class="tbody">
      <tr>
       <td>1.2.10</td>
       <td>
        <p class="para">
         对非集群的支持。
        </p>
        <p class="para">
         返回的数组元素现在也包括了
         <em>hostname</em> 和 <em>port</em>。
        </p>
       </td>
      </tr>

     </tbody>
    
   </table>

  </p>
 </div>


 <div class="refsect1 seealso" id="refsect1-mongoclient.gethosts-seealso">
  <h3 class="title">参见</h3>
  <ul class="simplelist">
   <li class="member"><span class="function"><a href="mongoclient.getconnections.html" class="function" rel="rdfs-seeAlso">MongoClient::getConnections()</a> - 返回所有已打开连接的信息</span></li>
  </ul>
 </div>

</div><hr /><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="mongoclient.getconnections.html">MongoClient::getConnections</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="mongoclient.getreadpreference.html">MongoClient::getReadPreference</a></div>
 <div class="up"><a href="class.mongoclient.html">MongoClient</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
